home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Monster Media 1996 #14
/
Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO
/
bbs_door
/
vfy_39.zip
/
4-TRIBBS.ZIP
/
TRISEC.DOC
< prev
next >
Wrap
Text File
|
1995-12-26
|
13KB
|
321 lines
**************************************************************
* *
* TRISEC.EXE v10.4 *
* *
* TRIBBS User Security Level Adjustment Program *
* *
* Copyright (c) 1993/95 *
* Sagerquist Micro Engineering *
* *
* 1414 W. Kerrick Street *
* Lancaster, Ca. 93534 *
* Data (805) 723-6908 *
* *
**************************************************************
DESCRIPTION
-----------
TRISEC.EXE adjusts a TRIBBS caller's security level in the TRIBBS
user database file USERS.DAT. This action is useful when invoking
BBS Doors such as a Call Back Verification, a Questionnaire or
Opinion Poll, etc., where the caller is to be rewarded with a
security level adjustment upon successful completion. The caller's
remaining time may also be altered.
SYNTAX
------
TRISEC [/S:(New Security Level)]
[/D:(Node Directory (location of SYSDAT2.DAT - optional)]
[/T=:[(New Remaining Time in Minutes)] <Registered only>
[/T+:[(Minutes to Add to Remaining Time] <Registered only>
Note: Either Security, Remaining Time or both may be adjusted.
The Security value is an optional value.
Note: Only one /T switch is allowed.
Note: /D:... switch is optional. It will override the default
value: C:\TRIBBS. If your TriBBS system is set up on a
different drive or directory, use the command line switch
to override the default values.
EXAMPLES
--------
TRISEC /S:100 /T+:30
TRISEC /T+:60
TRISEC /D:F:\TRIBBS /S:100
TRISEC /D:D:\TRIBBS /S:100 /T+:30
TRISEC ?
SAMPLE TRAP DOOR BATCH FILE
---------------------------
Note: TRIBBS places the callers logged actions into the file
CALLERS.LOG in the NWORK directory. When the caller hangs
up, all the information is written (appended) to the file
CALLERS.LOG in the MWORK directory. The CALLERS.LOG in
the MWORK directory is the permanent log. If VERIFY!.EXE
is going to log its action in CALLERS.LOG, be sure to
specify the CALLERS.LOG file in the NWORK directory with
the /L: switch.
Note: The DOORS.MNU entry would look like this:
T,Call Back Verification,VERIFY!,10
@ECHO OFF
ECHO ******* Entering VERIFY! *******>> C:\TRIBBS\NWORK\CALLERS.LOG
C:
CD C:\TRIBBS\VERIFY!
VERIFY! /B:TRIBBS /D:C:\TRIBBS /L:C:\TRIBBS\NWORK\CALLERS.LOG
rem ERRORLEVEL 0 and 1 means caller is verified.
rem ERRORLEVEL 0 == local call
rem ERRORLEVEL 1 == long distance
IF ERRORLEVEL 0 IF NOT ERRORLEVEL 2 goto ADJUST
goto END
:ADJUST
rem Adjust caller's security level to 50
C:\TRIBBS\SME_UTLS\TRISEC /S:50 /T=:90
:END
CD C:\TRIBBS
BOARD
TECHNICAL
---------
TRISEC.EXE was designed to compliment VERIFY!.EXE, a BBS Call Back
Verify program, and both were originally intended for use in a DOOR.
When a TriBBS DOOR launches, TriBBS creates DOORS.TMP. It contains
the caller's information. If values are changed in this file, the
data in TriBBS's databases are automatically updated. TRISEC.EXE
will change the data in DOORS.TMP to accomplish its goals.
TRISEC.EXE begins by reading the file SYSDAT2.DAT for the node in
operation. From there, all other system files can be found. Then
the file DOORS.TMP is read, where the User Record Number is
retrieved. The caller's record in the file USERS.DAT is updated
with the new security level. If the security level update is
successful, the file DOORS.TMP is updated with the remaining time
value (if defined). DOOR.SYS is then deleted, since values there
will override changes to USERS.DAT.
SHARE.EXE:
All files are opened in SHARE mode, allowing other applications
to access the files. The current user's record in USERS.DAT is
"locked" prior to changing any values which ensures other
applications cannot crash the system by trying to alter the same
area of the file. SHARE.EXE must be loaded for TRISEC to operate
on a multitasking system (multiple nodes). Without SHARE.EXE on
a multinode system, it is highly likely that TRISEC will fail when
accessing USERS.DAT. TRISEC will operate without SHARE.EXE on a
single node system.
If DOOR.SYS exists, TRISEC will delete it. Otherwise, the values
in DOOR.SYS will override the changes made to DOORS.TMP and
USERS.DAT.
On exit of TRISEC, ERRORLEVELs are returned. Your batch file can
check the ERRORLEVEL and determine what has happened. The following
is a list of TRISEC's ERRORLEVELs and their meaning:
ERRORLEVEL 0 Normal exit, adjustment successful.
ERRORLEVEL 1 Error exit, either a file cannot be found,
the adjustment cannot be made, the user's
name cannot be found, etc. The actual
reason for the error is written to the
screen.
Review your DOS manual for more information on ERRORLEVELs.
REGISTRATION
------------
This program is part of "The SME TriBBS Utilities Package"
which are released as Shareware. You are granted a 30 day limited
license for evaluation purposes. If you decide to continue its
use, registration is required.
The time adjustment function (from the /T+: and /T=: command line
switches) is disabled until registration.
Registration is for the entire package. Every program in the
package will operate on the same registration number. This number
is generated from the BBS's sysop name. The name entered on the
registration form must be the BBS's sysop name.
The registration fee is $20.00. California residents please add
8.25% sales tax of $1.65, total: $21.65
If the SME TriBBS Utility Package is purchased with or after
VERIFY!.EXE BBS Call Back Verifier, registration is only $10.00.
California residents please add 8.25% sales tax of $0.83.
Please print and fill out the file REGISTER.FRM, and send a check
or money order to:
Sagerquist Micro Engineering
1414 W. Kerrick St.
Lancaster, CA 93534
If you have any suggestions for improvement, or requests for
other utilities to add to this package, please contact
Carl Sagerquist through The SME Support BBS, or via mail.
Thank you for your support!
PROGRAMMING SERVICES
====================
TRISEC.EXE is a custom program, and performs exactly as requested.
Programming services are provided by Sagerquist Micro Engineering
by request. The points of contact are:
The SME Support BBS ----------> (805) 723-6908 28800 Baud
Internet E-Mail --------------> zs@qnet.com
Internet World Wide Web Page--> http://www.av.qnet.com/~zs/
Post Office "Snail Mail":
Sagerquist Micro Engineering
1414 W. Kerrick St.
Lancaster, CA 93534
If you have an idea for a program of any kind, please call!
DISCLAIMER
----------
This program is distributed as is. No warranty, either expressed or
implied is offered and the programmer is not responsible for any
damages or expenses that may occur through the use of this program.
The user shall determine its suitability. Extensive testing has been
performed and every effort has been made to ensure satisfactory
performance prior to release. Please communicate any difficulties
with the programmer through one of the contacts listed above. Any
problems received will be treated as a top priority.
CREDITS
-------
Thanks to James Mann of Littlerock, CA for requesting this program,
and testing it online.
Thanks to Robert Massman of Dallas TX for his assistance and
testing of this program on his TRIBBS system.
Thanks to Rick Bretz of Columbus, OH for finding the error in
version 1.2. The caller's alias was part of the check, and
apparently the caller's alias is not always included in the file
TRIBBS.SYS. Now, the caller's name and password is compared rather
than the caller's name and alias.
Thanks to John Knopf of Collierville, TN for his efforts with
TRIBBS v5.01 and TRISEC.EXE.
Thanks to Doug Torneden of Irving, TX for suggesting the additional
time function of this program, and for testing it online.
Thanks to Rick Bretz of Columbus, OH again, for his thorough work,
testing and communication in his setup of VERIFY!.EXE with TRISEC.EXE.
The work helped me understand the known difficulty mentioned above
much more thorough. Setup suggestion is more reliable.
Thanks to Mark Goodwin, author of TriBBS for releasing the source code
to the TriBBS database files, and for his assistance with all my
pestering questions and suggestions.
Extreme thanks to Dan Harvey of New Market, TN, (BBS (614) 932-1490)
for his diligence in testing TRISEC.EXE on his multinode BBS.
Without his fine, exacting and detailed error reporting, TRISEC would
not have been fully operational on multinode BBSs in multitasking
environments.
TRIBBS is copyrighted software by Mark Goodwin, 366 14th St.,
Bangor, ME 04401 BBS (207) 941-0805.
HISTORY
-------
10/25/95 v10.4 Command line switches reduced and TriBBS system
files located through SYSDAT2.DAT.
/U: and /TMP: command line switches deleted.
/D: switch now points to the directory location
of SYSDAT2.DAT, and TRISEC.EXE locates all other
necessary files through the directory structure
created on initial setup, or by TRIMAN.EXE when
setting up a new node.
10/21/95 v10.3 Altered file access: Shared opening of files now
allows other applications to access all files
TRISEC accesses. The current user record within
USERS.DAT is "locked" prior to writing any changes.
Also, if SHARE.EXE is not loaded, TRISEC will still
attempt to make the changes. This keeps TRISEC
compatible with non-multitasking systems where
SHARE.EXE is not loaded.
Fixed problem when TRISEC was called for nodes 2
and above, it would respond as not registered,
disabling time adjustments.
10/21/95 v10.2 TriSEC, (again) has been placed within The TriBBS
Utility Package requiring registration.
10/21/95 v10.1 Since the values in DOOR.SYS will override any
changes made to DOORS.TMP and USERS.DAT, TRISEC.EXE
now deletes DOOR.SYS if it exists.
The Security value is now optional. Time only may
now be adjusted.
10/20/95 v10.0 Recoded for compatibility with TriBBS v10.0.
06/01/95 v2.1 - Recoded for efficiency and appearance.
04/21/95 v2.0 - Program operation overhauled. DOORS.TMP is read
and adjusted. User record locating is more direct.
DOOR.SYS is no longer required to exist. In fact,
if it exists, DOOR.SYS is deleted.
Program screen output is changed, showing values
before and after the changes.
Registration as part of the SME Utility Package
removed. This program is free, included with
the VERIFY!.EXE program.
v1.9 - Test only, not released.
01/16/95 v1.8 - Adjusted processing of the /T=: command line switch.
10/22/94 v1.7 - TRISEC may now be called from a different directory.
The registration file SMETUTLS.REG now is found
within the TRISEC home directory.
- Command line overhauled, time may be added or
altered.
10/02/94 v1.6 - TRISEC.EXE added to the TriBBS Utilities Package.
02/18/94 v1.5 - Added code to add time (minutes) to the caller's
remaining time for the current call.
12/19/93 v1.4 - Added code to also alter DOOR.SYS to be compatible
with TRIBBS v5.01 and above.
08/18/93 v1.3 - The checking of the caller's alias from TRIBBS.SYS
is removed. Comparison check is now only the
caller's name and password from TRIBBS.SYS to
USERS.DAT.
08/15/93 v1.2 - More thorough checking of the caller against the
database in USERS.DAT.
- Command line suggestion no longer misleading.
07/24/93 v1.1 - In version 1.0, if there were more than 256 callers
in the file USERS.DAT, TRISEC's writing position
would start over at the beginning of the file for
record # 257. This would overwrite someone else's
record, effectively placing two records for that
caller into the file. FIXED!
06/05/93 v1.0 - First release.